﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>DN_HELP</title>
<meta http-equiv="Content-Type" Content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="../../../styles/styles.css">
<script language="javascript" src='../../links.js' type="text/javascript"></script>
</head>
<body>

<h1>DN_HELP</h1>
<div class=navbar>
<a href="../../index.html">главная</a> |
<a href="index_dn.html">события</a> |
<a href="../index.html">Dialog API</a>
</div>

<div class=shortdescr>
Событие <code>DN_HELP</code> передаётся в обработчик диалога перед выводом темы помощи.
</div>

<h3>Param1</h3>
<div class=descr>
ID элемента диалога, имеющий фокус ввода (текущий элемент).
</div>

<h3>Param2</h3>
<div class=descr>
Адрес строки, содержащей <a href="../../language/helptopic.html">название темы</a>, которая будет показана.
</div>

<h3>Return</h3>
<div class=descr>
Адрес строки темы подсказки, связанной с данным диалогом, который будет выведен. Если вернули <code>NULL</code>, то тема помощи выводиться не будет.
</div>

<h3>Элементы</h3>
<div class=descr>
<table class="cont">
<tr class="cont"><th class="cont" width="40%">Элемент</th><th class="cont" width="60%">Описание</th></tr>
<tr class="cont"><td class="cont" width="40%">Все</td>
<td class="cont" width="60%">Все элементы, которые могут иметь <a href="../../other/dict.html#keybfocus">клавиатурный фокус ввода</a>.</td></tr>
</table>
</div>

<h3>Замечания</h3>
<div class=descr>
Это сообщение позволяет управлять показом темы помощи на уровне отдельного элемента диалога.
</div>

<h3>Пример</h3>
<div class=descr>
<pre class=code>
// в зависимости от состояния игры показать тот или иной раздел помощи
// в данном случае текущий элемент диалога нас не интересует
case DN_HELP:
{
  static wchar_t *HelpTopics[3]={L"Contents",L"Rule",L"Recommendations"};
  int i=1;
  if(GAME[0].NumPl1==2 &amp;&amp; GAME[0].NumPl2 == 2)
    i=0;
  else if(GAME[0].NumPl1+GAME[0].NumPl2 &gt; 16)
    i=2;
  return (&amp;HelpTopics[i][0]);
}
</pre>
</div>


<div class=see>Смотрите также:</div><div class=seecont>
<a href="../../service_functions/dialoginit.html">DialogInit</a>
</div>

</body>
</html>
